home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / utilities / pu133.dms / pu133.adf / ARP / ARPUsersManual < prev    next >
Text File  |  1991-07-28  |  23KB  |  855 lines
  1.  
  2.  
  3.  
  4.              ARP Users Manual V1.1 (REL2)
  5.  
  6.  
  7.                 ARP    Users Manual V1.1
  8.                     (REL2)
  9.  
  10.  
  11.                    ABSTRACT
  12.  
  13.  
  14.  
  15.       Wherein we present some of the truly outstanding features
  16.       of the new ARP programs, attempting to point the way for
  17.       new users of ARP to take immediate advantage of the ARP
  18.       software. If you have    already    been using ARP for a while,
  19.       you might wish to begin reading with section 2.
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.                  CONTENTS
  75.  
  76.  
  77.        1.  General Features of ARP Programs....................      1
  78.        1.1    Command    format.................................      1
  79.        1.2    Commands and Templates.........................      3
  80.        1.3    Escapes........................................      5
  81.        1.4    ARP and    Wildcards..............................      7
  82.  
  83.        2.  Status of V1.1 (REL2) of ARP........................      8
  84.        2.1    Support    for Release 2..........................      8
  85.  
  86.        3.  REL2    improvements and additions.....................      9
  87.        3.1    Changes    to old commands........................      9
  88.         3.1.1  Assign  10
  89.         3.1.2  Type  10
  90.         3.1.3  Set and Environment variables  11
  91.        3.2    Introducing Resident and Resident Programs.....     11
  92.        3.3    Other new programs.............................     11
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.                   - i -
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.        ARP Users Manual       V1.1    Software (REL2)      February 27, 1988
  137.  
  138.  
  139.  
  140.        1.  General Features of ARP Programs
  141.  
  142.        Since one of the    goals of ARP is    to make    the Amiga easier
  143.        for you to use, we tried    as hard    as we could to make it
  144.        possible    for you    to install ARP,    and continue to    use
  145.        previously written batch    files without any change at all.
  146.        Additionally, you should    be able    to use the ARP programs
  147.        immediately, without learning anything more about them,
  148.        since the degree    of compatibility is very high.    However,
  149.        ARP programs are    generally enhanced and improved, and
  150.        generally much easier to    use.  To take advantage    of these
  151.        new features, you have to learn about them, so read on!
  152.  
  153.        1.1  Command format
  154.  
  155.        One of the problems with    the original AmigaDOS programs was
  156.        that they are too inconsistant. Some programs accepted 10 or
  157.        20 filenames, and also allowed you to use wildcards to
  158.        specify files.  Some programs accepted multiple files, but
  159.        didn't allow wild cards.    And some programs accepted only    one
  160.        filename. We have tried to fix this in ARP. Where it is
  161.        reasonable to expect to be able to supply multiple arguments
  162.        to a program, we    have provided that capability*.     Where it
  163.        is reasonable to    expect to be able to use wildcards, we have
  164.        provided    that capability    also.  We have attempted to make
  165.        the command templates for programs more consistant as well,
  166.        allowing    abbreviations for commonly used    switches and
  167.        options.
  168.  
  169.         Commercial or public domain    commands which use
  170.        arp.library will    be able    to implement this same kind of
  171.        consistant user interface.
  172.  
  173.         This consistant command interface provides a lot of
  174.        power.  As a simple example, consider the problem of dumping
  175.        a lot of    files to your printer for a quick reference.  Let's
  176.        say you want to send all    the files in the current directory
  177.        which end in ".c" to the    printer.  Due to the ARP command
  178.        structure, there    are no less than three ways to do this,    and
  179.        all of them use remarkably similar command lines:
  180.  
  181.  
  182.  
  183.  
  184.  
  185.        __________
  186.  
  187.      * In REL2 of ARP there    are no longer any limits to the
  188.        number of commands you may enter. See chap.2    for more
  189.        information.
  190.  
  191.  
  192.  
  193.  
  194.                  Page 1
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.        ARP Users Manual       V1.1    Software (REL2)      February 27, 1988
  203.  
  204.  
  205.  
  206.  
  207.      1> Type #?.c to PRT:
  208.      1> Copy #?.c to PRT:
  209.      1> Join #?.c to PRT:
  210.  
  211.  
  212.        Incidentally, we    also supply a more standard set    of
  213.        wildcards, in addition to the ones in use on the    Amiga, so
  214.        you could also do
  215.  
  216.  
  217.        1> Type *.c to PRT:
  218.        1> Copy *.c to PRT:
  219.        1> Join *.c to PRT:
  220.  
  221.  
  222.        If you were to try the same thing using the AmigaDOS
  223.        programs, you would be in for a rude shock.  First, let's
  224.        try type:
  225.  
  226.  
  227.        1> Type #?.c    to PRT:
  228.        Can't open #?.c
  229.  
  230.  
  231.        It appears that the AmigaDOS type doesn't understand
  232.        wildcards.  Well, let's try Copy:
  233.  
  234.  
  235.        1> Copy #?.c    to PRT:
  236.        Destination must be a directory
  237.  
  238.  
  239.        Cute, Copy lets you use wildcards, but then you can't copy
  240.        anything    to the printer.     It turns out that the only way    to
  241.        send all    your files to the printer is to    specify    each one in
  242.        full. And if you    wanted to use the special capabilities of
  243.        Type, for example, to add line numbers to the files as you
  244.        print them out, you are reduced to multiple Type    commands,
  245.        since the AmigaDOS type only accepts one    argument.  Using
  246.        the ARP Type, you can supply multiple arguments,    and each
  247.        argument    can contain wildcards.
  248.  
  249.         The    main point to notice here is how ARP provides you
  250.        with a consistant command environment.  Because the ARP
  251.        programs    don't impose artificial    limitations, each command
  252.        is more powerful    and more useful.  And because ARP programs
  253.        strive to be consistant with each other,    you don't have to
  254.        remember    silly special cases, and can apply what    you have
  255.        learned about one program to a new one.    For example, having
  256.        noticed that Copy, Join and Type    all allow wildcards, you
  257.  
  258.  
  259.  
  260.                  Page 2
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.        ARP Users Manual       V1.1    Software (REL2)      February 27, 1988
  269.  
  270.  
  271.  
  272.        can probably assume that    a command like Rename does as well,
  273.        and you would be    correct.  As another example of    the
  274.        increased power of ARP, let's say you wanted to move the
  275.        three files memo1, memo2    and memo3 to a directory on the
  276.        same disk called    OLD_EMOS. Using    AmigaDOS, you would have to
  277.        do it this way:
  278.  
  279.  
  280.        1> Rename memo1 OLD_EMOS
  281.        1> Rename memo2 OLD_EMOS
  282.        1> Rename memo3 OLD_EMOS
  283.  
  284.  
  285.        This kind of thing can get old pretty quickly.  Using the
  286.        ARP Rename, you would simply do
  287.  
  288.  
  289.        1> Rename memo? OLD_EMOS
  290.  
  291.  
  292.        The '?' is of course a wildcard that matches any    single
  293.        character.
  294.  
  295.        1.2  Commands and Templates
  296.  
  297.        When we spoke to    Amiga users, one of the    things they liked
  298.        about the current Amiga programs    were the use of    command
  299.        templates to specify the    arguments to a program.     Since
  300.        people liked this, and it seemed    like a good idea, we kept
  301.        it in ARP.  We extended and modified individual templates
  302.        for commands, and we also have an extended help feature.
  303.        Under AmigaDOS, if you supply a question    mark (?)  as the
  304.        first argument to a command, it presents    you with its
  305.        command template, and waits for you to hand it some
  306.        arguments.  The same thing is true of ARP programs, but if
  307.        you need    even more information, just type another question
  308.        mark when you get the template, like this:
  309.  
  310.  
  311.        1> Type ?
  312.        FROM/...,TO/k,OPT/k:    ?
  313.        Type    wildcards [TO Output] [OPT H(ex)|N(um)]
  314.        FROMA/...,TO/k,OPT/k:
  315.  
  316.  
  317.        The first thing Type gives you when you supply a    question
  318.        mark is its command template*.  If that is not enough
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.                  Page 3
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.        ARP Users Manual       V1.1    Software (REL2)      February 27, 1988
  335.  
  336.  
  337.  
  338.        information for you (for    example, if you    forget what options
  339.        you can pass to type), typing another question mark after
  340.        you get the template causes an additional help message to be
  341.        displayed, and then the template    is reprinted, and the
  342.        command waits again for you to supply it    with some
  343.        arguments.  This    allows you to get extra    help for commands
  344.        you don't use often, and    not be bothered    by a lot of
  345.        information for commands    that you do use    a lot.
  346.  
  347.         Another thing ARP tries hard to do is to give
  348.        informative error messages.  For    example, when you type the
  349.        following under AmigaDOS:
  350.  
  351.  
  352.        1> Echo "Hello World!
  353.        Bad Args to Echo
  354.  
  355.  
  356.        You get a not too helpful message.  The same action using
  357.        the ARP echo would cause:
  358.  
  359.  
  360.        1> Echo "Hello World!
  361.        Bad Args: Unmatched quotes
  362.  
  363.  
  364.        ARP attempts to help you    identify the problem, so you can
  365.        fix it more rapidly. As under AmigaDOS, you can supply
  366.        arguments to ARP    programs using either keywords,    or using**
  367.        positions:
  368.  
  369.  
  370.        1> Type infile
  371.        1> Type FROM    infile
  372.        1> Type FROM    infile TO outfile
  373.        1> Type OPT h TO outfile FROM infile
  374.  
  375.  
  376.        All of the above    will work.  In addition, if you    make an
  377.        error:
  378.  
  379.  
  380.  
  381.        __________
  382.  
  383.      * The template    type for the FROM keyword (/...) is an ARP
  384.        innovation, see chap.2 for more details.
  385.  
  386.     ** The template    keywords are given in upper case only for
  387.        clarity - you can use any case you like.
  388.  
  389.  
  390.  
  391.  
  392.                  Page 4
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.        ARP Users Manual       V1.1    Software (REL2)      February 27, 1988
  401.  
  402.  
  403.  
  404.  
  405.        1> Type FROM
  406.        Bad Args: Keyword needs an argument
  407.        or
  408.        1>  Type infile From    outfile
  409.        Bad Args: Bad positional argument
  410.  
  411.  
  412.        the ARP programs    once again attempt to help you diagnose    the
  413.        problem.    In the first example, you specified a file by
  414.        keyword (the FROM), but left off    the filename. (If you
  415.        really wanted to    type a file by the name    of FROM, you need
  416.        to use double quotes, for example, Type "FROM".    ARP
  417.        programs, like AmigaDOS programs, assume    that names inside
  418.        of quotes are filenames and not template    keywords.)  In the
  419.        second case, you    gave the first argument    twice, once by
  420.        position, and then by keyword.  Type doesn't know what you
  421.        mean, since you appeared    to have    misused    a positional
  422.        argument.
  423.  
  424.        1.3  Escapes
  425.  
  426.        AmigaDOS    programs regard    an asterisk inside of quotes as    an
  427.        'escape'    character, or a    character that has a special
  428.        meaning.     Typically, the    escape character is used to modify
  429.        the meaning of the character that follows the escape.  For
  430.        example,    "*F" would not display the two characters "*" and
  431.        "F", the    escape character "*" changes the meaning of the    "F"
  432.        character to a formfeed,    which will clear the terminal
  433.        screen, or advance the printer paper.
  434.  
  435.         A lot of people didn't care    for "*"    as an escape
  436.        character.  It is an unusual choice, most of the    popular
  437.        operating systems use a backslash (\) instead.  In addition,
  438.        the '*' character is a bit overloaded on    the Amiga, it
  439.        refers to the current window, the BCPL escape, and it is
  440.        also ARPs (and most other Operating Systems) universal
  441.        wildcard.  You can use the Set program to change    the
  442.        wildcard    character to a backslash like this:
  443.  
  444.  
  445.        Set ESCAPE \
  446.  
  447.  
  448.        Just substitute your favorite escape character for the \    in
  449.        the above example.  The examples    which follow assume you
  450.        have your escape    character set to a \, as shown above.
  451.  
  452.         ARP    recognizes the following characters as special when
  453.        preceeded by the    current    escape character:
  454.  
  455.  
  456.  
  457.  
  458.                  Page 5
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.        ARP Users Manual       V1.1    Software (REL2)      February 27, 1988
  467.  
  468.  
  469.  
  470.  
  471.        \N      Newline
  472.        \T      Horizontal Tab
  473.        \V      Vertical Tab
  474.        \B      Backspace
  475.        \R      Return
  476.        \F      Formfeed
  477.        \E      Escape (ascii    27)
  478.        \Xnn      Hex number nn
  479.  
  480.  
  481.        those of    you familiar with the limited escapes supported    by
  482.        AmigaDOS    will notice that ARP supports a    much greater
  483.        variety of escape characters and    options, although ARP
  484.        programs    (like AmigaDOS)    programs, will only recognize the
  485.        escape character    inside of double quotes*, so if    you want to
  486.        use escapes, you    must also use the double quotes.  To
  487.        include a single    escape inside of quotes, you need to use
  488.        two of them, like this "\\".  You can also include double
  489.        quotes inside of    double quotes, by escaping them    as well,
  490.        for example, "\"Inside Quotes\"".  As usual, of course, the
  491.        special escaped characters can be either    upper or lower
  492.        case.  If you use hex digits, there can be one or two of
  493.        them, and they can also be either upper or lower    case.
  494.        Escapes can be very convenient to use, for example, to
  495.        advance your printer paper to the next sheet, you can do:
  496.  
  497.  
  498.        1> Echo >PRT: "\F"
  499.  
  500.  
  501.        Which sends a formfeed to the printer.  You should generally
  502.        be careful about    using escapes in filenames, since this can
  503.        lead to confusion.  One place escape characters might be
  504.        appropriate is in Filenotes, for    example:
  505.  
  506.  
  507.        1> Filenote "Filename" "\X9B7mReverse Print Comment\X9B0m"
  508.  
  509.  
  510.        Which will cause    the filenote to    List in    reverse    print when
  511.        you display it, making it stand out more    clearly.
  512.  
  513.  
  514.  
  515.        __________
  516.  
  517.      * An exception    to this    is Echo, which always escapes its
  518.        arguments. This is an example of ARP    favoring
  519.        convenience over consistancy.
  520.  
  521.  
  522.  
  523.  
  524.                  Page 6
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.        ARP Users Manual       V1.1    Software (REL2)      February 27, 1988
  533.  
  534.  
  535.  
  536.        1.4  ARP and Wildcards
  537.  
  538.        ARP has an extensive set    of wildcards, and most ARP programs
  539.        allow them to be    used.  ARP supports ALL    of the AmigaDOS    set
  540.        of wildcards, as    well as    the more standard Unix*    style of
  541.        wildcards.  ARP supports    the following wildcard characters,
  542.        note that these are valid inside    or out of quotes:
  543.  
  544.  
  545.         (a|b|c)   Will match one of    a, b or    c.
  546.               These can    be patterns.
  547.  
  548.         ? Matches any single character
  549.         #<pat>   Pattern repeated 0    or more    times,
  550.              in    particular, #? matches anything.
  551.  
  552.         [char]   A set of characters, for example,
  553.              [abc] or [a..c] specify the same set.
  554.  
  555.         [^char]   Match everything but this    set of characters.
  556.  
  557.         *          0    or more    occurances of any character.
  558.  
  559.  
  560.        These can be used in combination, of course, so that *.(c|h)
  561.        or *.[ch] will match any    filenames ending in either .c or .h
  562.        preceeded by any    number of characters, including    no
  563.        characters.
  564.  
  565.         In addition, ARP allows wildcards to be used at
  566.        multiple    levels of a directory hierarchy.  For example, if
  567.        you want    to type    all the    files in all the directories of
  568.        your INCLUDE directory, you could use
  569.  
  570.  
  571.        1> Type DF0:Include/*/*
  572.  
  573.  
  574.        Which will take care of things nicely.  You can be more
  575.        selective, for example only typing files    that start with    T
  576.        in directories that start with E:
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.        __________
  584.  
  585.      * Unix    is a trademark of AT&T.
  586.  
  587.  
  588.  
  589.  
  590.                  Page 7
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.        ARP Users Manual       V1.1    Software (REL2)      February 27, 1988
  599.  
  600.  
  601.  
  602.  
  603.        1> Type DF0:Include/E*/T*
  604.  
  605.  
  606.        But the best way    to get used to the increased power of the
  607.        ARP wildcard system is to sit down and enjoy using it.
  608.  
  609.  
  610.  
  611.        2.  Status of V1.1 (REL2) of ARP
  612.  
  613.        This release fixes all known bugs in the    command    programs
  614.        and library, and    largely    meets ARP's initial goals of
  615.        freeing the Amiga from a    dependence on the BCPL library and
  616.        interface by replacing the command programs in the C
  617.        directory.  The few programs not    replaced are either already
  618.        in C (i.e., DiskCopy, Format) or    require    major integration
  619.        of new system components, such as NewCLI, RUN and Execute.
  620.        These are being worked on and will be released (possibly    as
  621.        a separate release) in the next few months.
  622.  
  623.         We have also added support for international date
  624.        formats in all the date handling    programs and in    the
  625.        library.     This was largely the work of Ken Salmon who also
  626.        contributed some    of the new command programs.
  627.  
  628.         The    initial    acceptance of ARP has been very
  629.        encouraging, and    we would like to thank the thousands of    new
  630.        users, especially those who sent    in bug reports and/or
  631.        suggestions.
  632.  
  633.        2.1  Support for Release 2
  634.  
  635.        There have been two preliminary releases    since version 1.0,
  636.        both of them for    magazines ("Transactor for the Amiga" and
  637.        "AmNews") which were carrying articles about ARP.  While
  638.        these releases represent    advances over Release 1, they will
  639.        not be supported.  This is the official second releases
  640.        (REL2) of ARP, with the corresponding version number of 1.1.
  641.        If you have one of these    preliminary versions of    ARP, please
  642.        upgrade to this one.
  643.  
  644.         You    can use    the ARP    Version    command    to get the current
  645.        versions    of Kickstart, Workbench    and ARP.  Another way to
  646.        get the ARP version is to type the following command from
  647.        the CLI:
  648.  
  649.            1> run LIBS:arp.library
  650.            LIBS:arp.library    failed returncode XX
  651.  
  652.  
  653.  
  654.  
  655.  
  656.                  Page 8
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.        ARP Users Manual       V1.1    Software (REL2)      February 27, 1988
  665.  
  666.  
  667.  
  668.         The    'XX' will be the current major revision    number of
  669.        arp.library.  For REL2, XX should read "34".  If    you have
  670.        one of these preliminary    releases, XX (or version) will be
  671.        32 or 33.
  672.  
  673.  
  674.        3.  REL2 improvements and additions.
  675.  
  676.        3.1  Changes to old commands
  677.  
  678.        A major change in all commands has been the introduction    of
  679.        a new argument template type.  This type    allows you to enter
  680.        any number of arguments to a command.  You are no longer
  681.        reduced to counting comma's to see how many arguments a
  682.        command requires.  Here is a comparison of the two:
  683.  
  684.         REL1 and ADos:
  685.  
  686.         Delete ,,,,,,,,,,  Allows 10 (?) arguments
  687.  
  688.         REL2 of ARP:
  689.  
  690.         Delete Files/...  Allows any number    of arguments.
  691.  
  692.  
  693.         we think the new template type is clearer, and much
  694.         more convenient to use.  Anytime you see this new
  695.         template type, please feel free to enter as    many
  696.         commands as    the current CLI    will let you.  This new
  697.         template type is used in most of the ARP commands that
  698.         expect multiple arguments, old and new.  The usage of
  699.         this template type is compatible with the older
  700.         templates, so this should not cause    any problems with
  701.         scripts or habits.
  702.  
  703.          Another command change/innovation is the use of
  704.         the    star "*" character in some commands to refer to    the
  705.         current directory.    Both Rename and    Copy use this
  706.         convention,    as well    as supporting a    limited    form of
  707.         prefix/postfix name    additions.  This is extremely
  708.         convenient,    and is another example of something ARP
  709.         brings to the Amiga    which has not been present in the
  710.         BCPL versions of these programs.
  711.  
  712.          Another change    which users should appreciate is
  713.         the    removal    of the recoverable alert (GURU)    when an    ARP
  714.         program could not find arp.library.     This caused some
  715.         confusion in the initial installations of arp, and we
  716.         have removed it at the small cost of making    programs
  717.         about 62 bytes larger.  You    will now get a message on
  718.         your terminal which    says "You need ArpLib V34+ or
  719.  
  720.  
  721.  
  722.                  Page 9
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.        ARP Users Manual       V1.1    Software (REL2)      February 27, 1988
  731.  
  732.  
  733.  
  734.         larger", instead of    the older guru meditation.  This
  735.         means either you do    not have an arp.library    in your
  736.         LIBS: logical directory, or    you do not have    the most
  737.         recent version.  There is also a new CLI command called
  738.         LoadLib that can help out in situations like this.    It
  739.         can    load arp.library (or any other library)    into the
  740.         Amiga and put it where programs can    find it.  This is
  741.         useful when    you must boot from a disk that does not
  742.         have arp.library on    it, but    still want to use the ARP
  743.         commands.  This occasionally occurs    with some copy
  744.         protected software.
  745.  
  746.          International date formats are    now supported for
  747.         both input and output.  Programs which use dates (Date,
  748.         List, SetDate) output dates    and expect input in the
  749.         format defined by the environment variable dateformat.
  750.         If no dateformat is    defined, they default to the
  751.         current AmigaDOS format.  The formats supported are:
  752.  
  753.            - AmigaDOS (the default)
  754.  
  755.            - International
  756.  
  757.            - United    States
  758.  
  759.            - Europe    and Canadia.
  760.  
  761.        3.1.1  Assign  Assign now uses the new multiarged templates,
  762.        but this    by itself is not enough    to earn    it a spot in this
  763.        overview.  REL2 of Assign allows    you to remove multiple
  764.        assignments, or mix adding and removing assignments on the
  765.        same line by using a dash (-) in    place of the directory
  766.        name.  For example:
  767.  
  768.       - Assign FOOBAR: DF0:    GROK: -    ARP: DF0:C
  769.  
  770.        This causes Assign to create assignments    for ARP    and FOOBAR,
  771.        but to delete any existing assignments for GROK.    Admittedly,
  772.        this is a strange syntax, but we    are constrained    by the
  773.        earlier Assign syntax so    we can't change    it to one more like
  774.        Set uses.
  775.  
  776.        3.1.2  Type  If you do not provide an input file    to Type    it
  777.        will expect to receive keyboard input.  It will send the
  778.        output to any file or device you    have specified on the
  779.        command line as its output.  This allows    you to send output
  780.        to the printer or disk files without having to enter into
  781.        collisions with the ARP supported wildcard (*) and the
  782.        original    AmigaDOS's current window character, which
  783.        unfortunately are the same thing.  (See the description of
  784.        Set, below).
  785.  
  786.  
  787.  
  788.                  Page 10
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.        ARP Users Manual       V1.1    Software (REL2)      February 27, 1988
  797.  
  798.  
  799.  
  800.         This is a convention widely    used in    advanced operating
  801.        systems,    and we are pleased to introduce    it to the Amiga.
  802.        Here are    two examples of    its use:
  803.  
  804.  
  805.        1> TYPE  TO PRT:
  806.        or
  807.        1> TYPE  TO DF0:MyFile
  808.  
  809.  
  810.        The first sends keyboard    output to the printer, while the
  811.        second diverts it to MyFile on drive 0. If you simply use
  812.        TYPE by itself, then it will echo your input to the current
  813.        window.
  814.  
  815.        3.1.3  Set and Environment variables  Set has several new
  816.        features. You can use Set to define your    choice of escape
  817.        character, and also to increase the level of BCPL
  818.        compatibility for a few commands.  Of course this must be
  819.        done at a cost, but it may occasionally be needed.  See the
  820.        Set manual page for more    information.
  821.  
  822.         There are also now two environment variables that are
  823.        used by the ARP programs, dateformat and    copyflags.  See    the
  824.        Environment manual page for more    information on these
  825.        variables.
  826.  
  827.        3.2  Introducing Resident and Resident Programs
  828.  
  829.        Thie release of ARP also    introduces resident programs to
  830.        Amiga users. These are programs which are loaded    into memory
  831.        once, no    matter how many    times they are executed.  These
  832.        programs    can be big memory savers, since    multiple
  833.        invocations of a    resident program will all use the same
  834.        code.  See the manual pages for Resident    and ARun for more
  835.        information on how to take advantage of this new    feature.
  836.  
  837.        3.3  Other new programs
  838.  
  839.        There are obviously many    new programs, in fact, this is
  840.        largely a complete set.    For descriptions of these, please
  841.        see the manual pages.
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.                  Page 11
  855.